Tcl 9.0.0 Release Announcement 


September 26, 2024 


The Tcl Core Team is pleased to announce the release of Tcl 9.0.0. This is the first stable 
release of Tcl 9.0. This should replace all prior alpha or beta releases. 


Tcl is the Tool Command Language originated by John Ousterhout and his team at U.C. 
Berkeley in the late 1980s. Its development is continued by the efforts of a global network 
of volunteers guided by the Tcl Core Team. 


We would like to express our gratitude to all those who submit bug reports and patches. 
This information is invaluable in enabling us to identify and eliminate problems. Such 
reports can be submitted here. 


Tel Ticket Tracker 


We ask that you log in (anonymous if you wish) to create tickets. This deters abuse of the 
ticketing system: 


Tel Contributor Login 


Where to get the new releases 


Tcl 9.0.0 sources are freely available as open source from the Tcl SourceForge project’s 
file distribution area: 


Tcl Source Distribution 


The Tcl 9.0.0 distribution is source code only. We keep links to some third parties offering 
pre-built binaries for various systems here: 


Tcl Binary Distribution 


Tel Summary 


The Tcl distribution delivers C source code that builds into a C library providing 
interpreters and related supports to execute programs written in the Tcl programming 
language. Source code for the application program tc1sh is also included. tclsh provides 
a Shell for either interactive execution of Tcl commands, or execution of files containing 
Tcl programs. 


Tcl is an extensible language, and the Tcl C library provides interfaces for the creation of 
extension libraries adding new commands and features to the core Tcl command set. Tcl 9 
debuts the full feature set needed to package an application written in C and Tcl into a 
single file executable exploiting virtual filesystem archives. 


Tcl 9 Release Summary 


This is a new major version of Tcl. When compared with the prior release Tcl 8.6, there 
are new features to be enjoyed. There are incompatibilities to be considered. A summary of 
the most noteworthy changes is found below. 


We believe many Tcl programs written for Tcl 8 will run unchanged in Tcl 9. We believe 
many more Tcl programs can be modified in small and simple ways to produce a new 
program that runs in both Tcl 8 and Tcl 9. We expect that extensions and applications 
using Tcl’s public C APIs will involve more effort, but that it is still within reasonable reach 


to produce source code supporting both Tcl 8 and Tcl 9 while both releases remain in 
widespread use. 


The experiences of Tcl 8 users adapting their code to Tcl 9 will determine the need for 
possible Tcl 8.7 releases that might supply additional lifecycle and migration support. 
Please use the Ticket Tracker to share your experiences and difficulties. 


See the following Inks for an accumulation of migration advice: 


[Migrating C extensions to Tcl 9] (https://core.tcl-lang. org/tcl/wiki? 
name=Migrating+C+extensionst+tot+TcH9) 


[Migrating scripts to Tcl 9] (https://core.tcl-lang.org/tel/wiki? 
name=Migrating+scripts+to+TcH9) 


There has been much progress already porting many known applications, extensions, and 
packages in the Tcl world to compatibility with Tcl/Tk 9: 


[Apps confirmed to work with Tcl 9] (https://wiki.tcl 
lang.org/page/Apps+confirmed+to+work+with+TcH9) 


[Porting extensions to Tcl 9] (https://wikitcllang.org/page/Porting+extensions+tot+Tcl+9) 


Tcl Improvement Proposals (TIPs) 


Each new user-visible feature in Tcl should find its origins in a Tcl Improvement Proposal 
(TIP). TIPs are published, edited, considered and voted in public, and should contain 
valuable information about how a feature came to be the way it is. See the full collection 
here: 


TIP Index 


Tcl Changes Summary 


(from changes.md in the source code distribution) 


The source code for Tcl is managed by fossil. Tcl developers coordinate all changes to the 
Tcl source code at 


Tcl Source Code 
Release Tcl 9.0.0 arises from the check-in with tag core-9-0-0. 


Highlighted differences between Tcl 9.0 and Tcl 8.6 are summarized below, with focus on 
changes important to programmers using the Tcl library and writing Tcl scripts. 


Major Features 


64-bit capacity: Data values larger than 2 GB 


e Strings can be any length (that fits in your available memory) 
e Lists and dictionaries can have very large numbers of elements 


Internationalization of text 


Full Unicode range of codepoints 

New encodings: ut f-16/utf-32/ucs-2(le|be), CESU-8, etc. 
encoding options -profile, -failindex manage encoding of I/O. 
msgcat supports custom locale search list 


eeee 


source defaults to -encoding utf-8 


Zip filesystems and attached archives 


e 


e 


Packaging of the Tcl script library with the Tcl binary library, meaning that the 
TCL_LIBRARY environment variable is usually not required. 

Packaging of an application into a virtual filesystem is now a supported core Tcl 
feature. 


Unix notifiers available using epoll() or kqueue() 


This relieves limits on file descriptors imposed by legacy select() and fixes a 
performance bottleneck. 


Incompatibilities 


Notable incompatibilities 


e 


eeee 
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e 


Unqualified varnames resolved in current namespace, not global. Note that in almost all 
cases where this causes a change, the change is actually the removal of a latent bug. 
No --disable-threads build option. Always thread-enabled. 

I/O malencoding default response: raise error (-profile strict) 

Windows platform needs Windows 7 or Windows Server 2008 R2 or later 

Ended interpretation of ~ as home directory in pathnames. (See file home and file 
tildeexpand for replacements when you need them.) 

Removed the identity encoding. (There were only ever very few valid use cases for 
this; almost all uses were systematically wrong.) 

Removed the encoding alias binary to iso8859-1. 

$::tcl_precision no longer controls string generation of doubles. (If you need a 
particular precision, use format.) 

Removed pre-Tcl 8 legacies: case, puts and read variant syntaxes. 

Removed subcommands [trace variable|vdelete|vinfo] 

Removed -eofchar option for write channels. 

On Windows 10+ (Version 1903 or higher), system encoding is always utf-8. 
%b/%d/%o/%x format modifiers (without size modifier) for format and scan always 
truncate to 32-bits on all platforms. 

%L size modifier for scan no longer truncates to 64-bit. 


e Removed command ::tcl::unsupported::inject. (See coroinject and 


coroprobe for supported commands with significantly more comprehensible 
semantics.) 


Incompatibilities in C public interface 


Extensions built against Tcl 8.6 and before will not work with Tcl 9.0; ABI 
compatibility was a non-goal for 9.0. In most cases, rebuilding against Tcl 9.0 should 
work except when a removed API function is used. 

Many arguments expanded type from int to Tcl_Size, a signed integer type large 
enough to support 64-bit sized memory objects. The constant TCL_AUTO_LENGTH is a 
value of that type that indicates that the length should be obtained using an appropriate 
function (typically strlen() for char * values). 


e Ended support for Tcl1_ChannelTypeVersion less than 5 
e Introduced versioning of the Tcl_ObjType struct 
e Removed macros CONST*: Tcl 9 support means dropping Tcl 8.3 support. (Replaced 


with standard C const keyword going forward.) 
Removed registration of several Tc1_ObjTypes. 


e Removed API functions: 


© Tcl_Backslash() 
© Tcl_*VA() 


Tcl_*MathFunc*() 
Tcl_MakeSafe() 
Tcl_(Save|Restore|Discard|Free)Result() 
Tcl_EvalTokens() 
Tcl_(Get|Set)DefaultEncodingDir() 
Tcl_UniCharN(case)cmp() 

© Tcl_UniCharCaseMatch() 
e Revised many internals; beware reliance on undocumented behaviors. 
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New Features 


New commands 


e array default — Specify default values for arrays (note that this alters the behaviour 
of append, incr, lappend). 

array for — Cheap iteration over an array’s contents. 

chan isbinary — Test if a channel is configured to work with binary data. 
coroinject, coroprobe — Interact with paused coroutines. 

clock add weekdays — Clock arithmetic with week days. 

const, info const* — Commands for defining constants (variables that can’t be 
modified). 

e dict getwithdefault — Define a fallback value to use when dict get would 
otherwise fail. 

file home — Get the user home directory. 

file tempdir — Create a temporary directory. 

file tildeexpand — Expand a file path containing a ~. 

info commandtype — Introspection for the kinds of commands. 

ledit — Equivalent to lreplace but on a list in a variable. 

1lpop — Remove an item from a list in a variable. 

1lremove — Remove a sublist from a list in a variable. 

1seq — Generate a list of numbers in a sequence. 

package files — Describe the contents of a package. 

string insert — Insert a string as a substring of another string. 

string is dict — Test whether a string is a dictionary. 

tcl::process — Commands for working with subprocesses. 

*::build-info — Obtain information about the build of Tcl. 

readFile, writeFile, foreachLine — Simple procedures for basic working with 
files. 

e tcl::idna::* — Commands for working with encoded DNS names. 
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New command options 


e chan configure ... -inputmode ...— Support for raw terminal mput and 
reading passwords. 

clock scan ... -validate ... 

info loaded ... ?prefix? 

Isearch ... -stride ... — Search a list by groups of items. 

regsub ... -command ...— Generate the replacement for a regular expression by 
calling a command. 

socket ... -nodelay ... -keepalive ... 

vwait controlled by several new options 

expr string comparators 1t, gt, le, ge 

expr supports comments inside expressions 


eeee 


Numbers 


e NNN format is no longer octal interpretation. Use @oNNN. 
e @dNNNN format to compel decimal interpretation. 
e NN_NNN_NNN, underscores in numbers for optional readability 


e Functions: isinf(), isnan(), isnormal(), issubnormal(), isunordered() 
e Command: fpclassify 
e Function int() no longer truncates to word size 


TclOO facilities 


private variables and methods 

class variables and methods 

abstract and singleton classes 
configurable properties 

method -export, method -unexport 


eeeee 


Known bugs 


changed behaviour wrt command names, namespaces and resolution 


windows dos device paths inconsistencies and missing functionality 
zlib-8.8, zlib-8.16 fail on Fedora 40, gcc 14.1.1 


Temporary folder with file “‘tcl9registry13.dll’” remains after “exit” 


For additional information: 


Please visit the Tcl Developer Xchange web site: 


Tcl Developer Xchange 


This site contains a variety of information about Tcl/Tk in general, the core Tcl and Tk 
distributions, Tcl development tools, and much more. 


— Tcl Core Team and Maintainers Don Porter, Tcl Core Release Manager 


